Ircle makes use of AppleScriptâ„¢ to automate tasks. AppleScript is a scripting language/software that comes with System 7.5 or higher. It is also available for System 7.1 but then you need to download the AppleScript Installer from the Apple sites. The AppleScript software needs to be installed to be able to run the scripts.
Get AppleScript at http://www.applescript.apple.com .
You can also download the AppleScript Language guide there.
(Note: if you install AppleScript use the installer....AppleScript is more than just one extension.)
How to use AppleScripts with Ircle.
To run a script in Ircle type /scriptname. For example: /colorgreet .
The script will be executed and unloads after completion.
Some scripts can be loaded into ircle memory permanently and will process events sent by ircle (text coming in, timer events, etc.). Type /load scriptname or /load to load them. Type /unload to delete it from ircle memory. Ircle wont send events to the script anymore.
Only one script can be loaded at a time.
You can create/edit AppleScripts yourself by using the Script Editor that comes with the AppleScript installation.
On the ircle home page (http://www.ircle.com) you will find links to documentation and scripts made by others.
This scripts folder contains only some sample applescripts for ircle.
More scripts and script developer info are (soon) available in the Ircle ScriptPack.
Explaining the scripts:
m
---
A command alias.
This script act likes /msg.
Usage: /m <nickname | #channelname> <text>
j
--
A command alias.
This script acts like /join.
Usage: /j <#channelname> [password]
k
--
Again a command alias.
This script acts like /kick, only now you don't have to give the channelname. It use the current channel.
Usage: /k <nickname> [kickmessage]
f2c
--
Fahrenheit to Celsius conversion script.
Usage: /f2c <number>
c2f
--
Celsius to Fahrenheit conversion script.
Usage: /c2f <number>
Masstrout
--------
This script will 'slap' all the users you have selected in the userlist with an object. This object you have to 'tell' the script.
Usage: /masstrout <slapobject>
CountOps
--------
This script will count all operators in the current channel and will send the result to the channel.
Usage: /countops
Colorgreet
---------
This script will hug all users in the current channel. Every nickname will be in a different color.
Usage: /colorgreet
NOTE: some channels don't appreciate colors or abuse of colors...you will be kicked.